home *** CD-ROM | disk | FTP | other *** search
/ Business Assistant / Business Assistant.iso / tax / splus2 / arce.doc < prev    next >
Text File  |  1989-03-03  |  12KB  |  422 lines
  1.  
  2.  
  3.   ARCE Command                                          Version 4.0c
  4.   ------------                                          Mar  3, 1989
  5.  
  6.  
  7.   Purpose:  Use ARCE to extract files from an ARC archive file.
  8.  
  9.   Format:
  10.  
  11.         ARCE  [d:][path]filename.ext  [filespecs...] [d:outpath]
  12.                                       [/R]
  13.                                       [/Q]
  14.                                       [/P]
  15.                                       [/T]
  16. |                                     [/5]
  17.                                       [/Gpassword]
  18.  
  19.   Remarks:
  20.  
  21.         The drive and path names are optional.  If omitted, the  current
  22.         drive and path name is used.
  23.  
  24.         The filename must be  supplied.  The extension defaults  to ARC.
  25.         All files matching the supplied filename are processed.  The ARC
  26.         filename may contain the * and ? wildcard characters.
  27.  
  28.         If  no  filespecs  are   supplied,  all  files  are   extracted.
  29.         Otherwise, only those ARC members  which match one of the  up to
  30.         16 filespecs are extracted.
  31.  
  32.         The extracted files  may be placed  on another drive,  and/or in
  33.         another subdirectory by following the optional filespecs with  a
  34.         drive designator and/or path name.
  35.  
  36.         If  the  file  being  extracted  already  exists,  you are asked
  37.         whether or not you want to over-write it.  You may use the |  /R
  38.         option to bypass this prompt.  Use a Y followed by the |  return
  39.         key to over-write the file.
  40.  
  41.         Use the /Q option to suppress alarm sounds, beeps, and bells.
  42.  
  43.         Use  the  /P  option  to  write  the  extracted files to the DOS
  44.         standard output  file.  With  /P, you  may pipe  or redirect the
  45.         output.  An initial line feed  is added to the beginning  of the
  46.         output file.
  47.  
  48.         Use the /T option to test the archive's integrity. No files will
  49.         be extracted.
  50.  
  51.         If the file was encrypted, use the /G option to supply the  same
  52.         password as was used to create the file, e.g. /GSECRET.
  53.  
  54. |       Use the /5 option to stop ARCE from creating the subdirectories
  55. |       for files created with the ARC /Z subdirectory option.
  56.  
  57.  
  58.         ARCE 4.0c, Copyright (c) 1986-89, Wayne Chin and Vernon D. Buerg.
  59.         ALL RIGHTS RESERVED.
  60.  
  61.  
  62.  
  63.   ARCE Command                                          Version 4.0c
  64.   ------------                                          Mar  3, 1989
  65.  
  66.  
  67.  
  68.                         Examples
  69.                         --------
  70.  
  71.         o  Extract all file from TEST.ARC onto the current drive:
  72.  
  73.               ARCE TEST
  74.  
  75.         o  Extract only file with  an extension of .ASM from the archive
  76.            SOURCE.ARC on drive B and in subdirectory SAVE:
  77.  
  78.               ARCE B:\SAVE\SOURCE *.ASM
  79.  
  80.         o  Extract  all  files  from  all  ARC files in the subdirectory
  81.            called TEST on drive C:
  82.  
  83.               ARCE C:\TEST\*
  84.  
  85.         o  Extract  all  files  from  PROGA.ARC  and  place the files in
  86.            subdirectory OLD on drive B:
  87.  
  88.               ARCE PROGA.ARC B:\OLD
  89.  
  90.         o  Extract all files with an extension of .COM and .EXE from the
  91.            archive PROGS.ARC in directory NEW\WORK on drive B, and place
  92.            the  them  in  subdirectory  SAVE\TEST  on  drive  A; replace
  93.            existing file:
  94.  
  95.               ARCE B:\NEW\WORK\PROGS *.COM *.EXE A:\SAVE\TEST /R
  96.  
  97.         o  Extract  the  file  READ.ME  from  the  archive GIZMO.ARC and
  98.            display it on the console instead of writing it to a file:
  99.  
  100.               ARCE GIZMO READ.ME /P
  101.  
  102.         o  Same as above, except  pass the extracted READ.ME file to the
  103.            LIST file viewer:
  104.  
  105.               ARCE GIZMO READ.ME /P | LIST /S
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.   ARCE Command                                          Version 4.0c
  124.   ------------                                          Mar  3, 1989
  125.  
  126.                         Error Messages
  127.                         --------------
  128.  
  129.       'filename - premature EOF reading '
  130.  
  131.         Data  is  missing  from  the  archive  file.   The  program   is
  132.         terminated.
  133.  
  134.  
  135.       'filename - unable to set file datestamp'
  136.  
  137.         The file datestamp is set to the current date and time, and  the
  138.         next archive member is processed.
  139.  
  140.  
  141.       'filename - WARNING: file CRC does not match!'
  142.  
  143.         The extracted member  is left on  the output disk,  and the next
  144.         archive member is processed.   The file is probably  invalid but
  145.         is left on the disk for your examination.
  146.  
  147.  
  148.       'Invalid filespec(s)'
  149.  
  150.         The filespec syntax is incorrect.  The filename part may be from
  151.         1  to  eight  characters,  and  may  include the ? or * wildcard
  152.         characters.  The extension may be none to three characters,  and
  153.         may  include  wildcards.   There  is  a  maximum of 16 filespecs
  154.         allowed.  The program terminates.
  155.  
  156.  
  157.       'filename - file already exists. Overwrite it? (y/N) '
  158.  
  159.         The member being extracted already  exists.  If you are using  a
  160.         data  path  utility,  the  file  may  not  actually  be  in  the
  161.         subdirectory be used for output.   Respond with the letter Y  to
  162.         over-write the existing  file, or respond  with the letter  N to
  163.         skip this member and continue to the next.
  164.  
  165.  
  166.       'Abort: Stack overflow'
  167.  
  168.         The member  being extracted  has invalid  data.  The  program is
  169.         terminated.
  170.  
  171.  
  172.       'filename - invalid decode tree count'
  173.  
  174.         The member  being extracted  has invalid  data.  The  program is
  175.         terminated.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.   ARCE Command                                          Version 4.0c
  184.   ------------                                          Mar  3, 1989
  185.  
  186.                         Error Messages (cont'd)
  187.                         --------------
  188.  
  189.  
  190.       'filename - new archive format 7 not yet supported'
  191.  
  192.         Format 7 is a special file compression method used internally by
  193.         SEA,  the  authors  of  ARC.  Processing continues with the next
  194.         archive member.
  195.  
  196.  
  197.       'Unable to open archive > arcname'
  198.  
  199.         The  specified  ARC   archive  file  was   not  found,  or   was
  200.         inaccessible.  The program terminates.
  201.  
  202.  
  203.       'CREATE failed > filename'
  204.  
  205.         There was insufficient directory  space, or a failure  accessing
  206.         the output disk.  The program terminates.
  207.  
  208.  
  209.         'Invalid archive format!'
  210.  
  211.         The archive file data is invalid.  The program terminates.
  212.  
  213.  
  214.       'Incorrect DOS version'
  215.  
  216.         Version  2.0  or  later  of  PC  DOS  must be used.  The program
  217.         terminates
  218.  
  219.  
  220.       'Not enough memory.'
  221.  
  222.         A minimum  of 112k  bytes of  memory is  required.  The  program
  223.         terminates.
  224.  
  225.  
  226.       'I/O error reading from arcname'
  227.  
  228.         An incorrectable error occurred attempting to read data from the
  229.         archive file.  The program terminates.
  230.  
  231.  
  232.       'I/O error writing or disk full > filename'
  233.  
  234.         There was not  enough disk space  to write the  complete archive
  235.         member.   The  partially  extracted  file  is  scratched and the
  236.         program terminates.
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.   ARCE Command                                          Version 4.0c
  244.   ------------                                          Mar  3, 1989
  245.  
  246.                         Error Messages (cont'd)
  247.                         --------------
  248.  
  249.  
  250.       'No matching file(s) found'
  251.  
  252.         No archive files were  found that matched the  supplied filename
  253.         specifications.  The program terminates.
  254.  
  255.  
  256.  
  257.       'filename - ERROR: invalid file codes'
  258.  
  259.         An error was detected while attempting to decode a crunched
  260.         file. Either some data bytes are invalid, there are extra
  261.         bytes, or there are bytes missing. The archive is invalid.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.   ARCE Command                                          Version 4.0c
  304.   ------------                                          Mar  3, 1989
  305.